跳到主要内容

首尾帧生视频

更新时间：2026-04-13
根据首尾帧图片生成视频，仅支持异步模式。调用该接口前，您需要先通过调用「上传文件」接口获取输入的原图路径；调用该接口后，您可通过调用「查询任务生成结果」接口获取视频的生成结果。
POST
https://cloud.baicaiinfer.com/v1/videos/generations
Authorizations
Authorizations：StringHeaderRequired

用户需使用已获取的API Key进行身份验证，以访问服务。

Body
application/json
selected_model：StringRequired

模型名称。更多模型，可参考支持的模型和应用。

取值范围：Viduq2-pro-FLF2V
默认值：-
约束限制：-
task_type：StringRequired

指定生成式模型需执行的任务类型。更多任务类型，可参考支持的模型和应用。

取值范围：flf2video
默认值：-
约束限制：-
input：ObjectRequired

输入参数集合。

input.image：StringRequired

首帧图。

取值范围：-
默认值：-
约束限制：图片要求：格式为PNG或JPG，大小≤50MB。
input.last_image：StringRequired

尾帧图。

取值范围：-
默认值：-
约束限制：图片要求：格式为PNG或JPG，大小≤50MB。
input.prompt：StringRequired

是生成视频时用于描述期望内容提示词。

取值范围：1~5000
默认值：-
约束限制：支持中英文。
input.resolution：StringRequired

分辨率。

取值范围：540p、720p、1080p
默认值：-
约束限制：-
input.aspect_ratio：String

无需指定，以输入的首帧图的宽高比输出。

取值范围：-
默认值：-
约束限制：-
input.duration：IntRequired

视频时长，单位s。

取值范围：5、6、8
默认值：-
约束限制：-
input.number_of_videos：Int

指定生成视频的数量。

取值范围：1~4
默认值：1
约束限制：-
need_expand_prompt：Boolean

是否打开提示词优化。

取值范围：true、false
默认值：false
约束限制：-
async：Boolean

是否采用异步方式处理请求。

取值范围：true、false
默认值：true
约束限制：-
Response
状态码：
200
application/json
code：IntRequired

表示请求处理状态的状态码。

0是成功标识，表示接口正常返回预期结果。
message：StringRequired

返回请求的处理结果，通常配合状态码使用，直观告知用户当前请求的具体情况。

data：objectRequired

任务的核心结果数据。

data.taskId：StringRequired

任务的唯一标识ID。

ts：StringRequired

响应的时间戳。

curl --location --request POST 'https://cloud.baicaiinfer.com/v1/videos/generations' \
--header 'Authorization: Bearer sk-VStOhW7gwGTcy5lFuDg*****' \
--header 'Content-Type: application/json' \
--data-raw '{
    "selected_model": "Viduq2-pro-FLF2V",
    "task_type": "flf2video",
    "input": {
         "image": "https://s1.llamafactory.online/baicai-infer/users/7e4113a5a1284465831eaefaa0022a98/12.png",
         "prompt": "小狗起身轻嗅，镜头转场到午后乐园，男孩笑着奔向镜头，阳光与绿意贯穿始终。",
         "resolution": "1080p",
         "duration": 5,
         "last_image": "https://s1.llamafactory.online/baicai-infer/users/7e4113a5a1284465831eaefaa0022a98/13.png"
    }
 }'

{
    "code": 0,
    "message": "任务提交成功",
    "data": {
        "taskId": "3524e0b3ba014b12ab1faf29f9f*****"
    },
    "ts": "2026-02-02T10:44:54.716004004+08:00[Asia/Shanghai]"
}